home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 15 / BBS in a box XV-1.iso / Files / System 7 / P-Q / QK-AppleScript.sit / Read Me (QK AppleScript Ext.) < prev   
Encoding:
Text File  |  1993-04-12  |  4.7 KB  |  90 lines  |  [TEXT/ttxt]
  1. April 9, 1993
  2.  
  3. Welcome to the AppleScript™ Extension for QuicKeys™.
  4.  
  5. Apple recently shipped AppleScript, a scripting language for controlling Apple Event aware applications.
  6.  
  7. The AppleScript Extension gives QuicKeys the ability to send AppleScripts.  An AppleScript shortcut can work alone or as a step in a sequence.
  8.  
  9. QuicKeys support for AppleScript extends the functionality and usability of BOTH products.
  10.  
  11. QuicKeys adds these capabilities to AppleScript which AppleScript could not do alone.
  12.   • run a script at a specific time (or interval)
  13.   • run a script from a keystroke
  14.   • start a script in a modal dialog box
  15.   • control programs with no (or limited) support of Apple Events and AppleScript
  16.   • "bridge" between applications that support AppleScript and those that do not.
  17.  
  18. AppleScript adds these capabilities to QuicKeys which QuicKeys could not do alone.
  19.   • perform calculations
  20.   • have more reliable control of some applications (those which support AppleScript)
  21.   • control applications on multiple machines
  22.  
  23. - - - - - - - - -
  24. INSTALLATION INSTRUCTIONS AND REQUIREMENTS
  25.  
  26. Requirements:
  27.   • QuicKeys v2.1 or later (v2.1.3 is recommended)
  28.   • CEIAC v2.0as or later (v2.0as is included with the AppleScript Extension)
  29.   • AppleScript v1.0 or later
  30.   • System 7.0 or later
  31.  
  32. Installation Instructions:
  33.   1.  Use the QuicKeys Extension Manager to install the AppleScript Extension.  The Extension Manager can be found in the QuicKeys Utilities folder on your hard drive or on disk 2 of your QuicKeys package.
  34.  
  35.   2.  If CEIAC is currently running on your machine, select CEIAC in the Applications menu, and then select Quit in CEIAC's File menu.
  36.  
  37.   3.  Drag the new CEIAC (v2.0as) icon onto your System Folder icon.  This will copy the new CEIAC to the Extensions folder, replacing any previous version of CEIAC.
  38.  
  39.   4.  Restart to install the new software.
  40.  
  41. - - - - - - - - -
  42. USING THE APPLESCRIPT EXTENSION
  43.  
  44. To create an AppleScript shortcut, open the QuicKeys editor, and then select AppleScript in the Extensions menu in the Define menu.
  45.  
  46. The AppleScript shortcut editor screen appears.
  47.  
  48. You may enter a script of up to 2000 (2K) characters directly into the shortcut editor or specify a text file containing the script.  Select the Modify Text button to enter the script directly or the Specify File button to tell QuicKeys which text file contains the script.
  49.  
  50. NOTE:  The AppleScript Extension does not check syntax before it sends the script.  We recommend that you initially write your script in Apple's AppleScript editor, check the syntax, and then paste it into QuicKeys.
  51.  
  52. If your script includes the Clipboard contents, the Script Uses Clipboard button should be checked.  The script must begin with "On Open QKClipboard" and end with "End Open".  Your script can then refer to the Clipboard "as passed" in the global variable "QKClipboard".
  53.  
  54. If your script returns a result, use the Results pop-up menu to specify what QuicKeys should do with the result:
  55.   • Ignore it—nothing happens
  56.   • Type it—QuicKeys will convert the result to text and type it (up to 255 characters)
  57.   • Display it—QuicKeys will convert the result to text, and then display the result in a dialog box (up to 255 characters)
  58.   • Put it on the Clipboard—QuicKeys will put the result on the Clipboard.  Some programs (such as Microsoft Word) may not be able to access this Clipboard.  If this occurs, put the AppleScript shortcut in a sequence that brings the Finder to the front, sends the AppleScript, and then brings Microsoft Word to the front.
  59.  
  60. An AppleScript shortcut can be triggered by a keystroke, timer, QuicKeys menu, SoftKeys palette, QK Icon, or any other method of triggering QuicKeys shortcuts.
  61.  
  62. - - - - - - - - -
  63. CHANGE HISTORY
  64.  
  65. CEIAC v2.0 - v2.0as
  66.   • Increased CEIAC application memory for AppleScript compatibility
  67.  
  68. AppleScript v1.0
  69.   • Initial release of AppleScript Extension for QuicKeys
  70.  
  71. ==================================================================
  72. © 1993 CE Software, Inc.  All Rights Reserved.
  73.  
  74. QuicKeys, QuicKeys 2, TAA, Technical Assistance Assistant, CEToolbox, QuickMail, DiskTop, Extension Manager, Type Ease, Paste Ease, Grab Ease, Screen Ease, Mounty, Choosy, DisMounty, and CEIAC are trademarks of CE Software, Inc.  All other trademarks are the property of their respective holders.
  75.  
  76. CE Software, Inc.
  77. P.O. Box 65580
  78. West Des Moines
  79. Iowa  50265  U.S.A.
  80. (515) 224-1995
  81. FAX:  (515) 224-4534
  82. QuickMail:  (515) 224-1721
  83. Technical Support:  (515) 224-1953
  84.  
  85. Support Forums:
  86. AppleLink - Third Parties (visible with AppleLink v6.0 or later) - CE Software
  87. America Online - Industry Connection (keyword: cesoftware)
  88. CompuServe - Mac A Vendors Forum -  (go macaven, library 4)
  89. GEnie - CE Software Round Table - (go page 1005, the command is m1005)
  90. CONNECT - Vendor Support - CE Software (no keywords)